For WOOMOB-1170

Description

This PR implements POS catalog sync endpoints with full catalog generation capabilities. The catalog download URL is provided in the job API response when it is complete.

Key Changes:

Catalog Generation Endpoints:

• generateCatalog(for:forceGenerate:) - Initiates asynchronous catalog generation and returns a job ID
  • POST /wp-json/wc/v3/catalog with fields=["id", "name", "type", "sku", "global_unique_id", "price", "regular_price", "sale_price", "on_sale", "downloadable", "parent_id", "images", "attributes", "manage_stock", "stock_quantity", "stock_status"] with CatalogGenerationResponse
• checkCatalogStatus(for:jobID:) - Checks catalog generation job status and provides download URL when complete
  • GET /wp-json/wc/v3/catalog/status/$job_id with CatalogStatusResponse

Response Models:

• CatalogGenerationResponse - Contains job ID job_id: string for tracking catalog generation
• CatalogStatusResponse - Parses status: string, progress: float, and download_url: string? (available when the job is complete) for catalog jobs
• CatalogStatus enum - Defines pending, processing, and complete states

Catalog generation works asynchronously - merchants initiate generation with generateCatalog, then poll status with checkCatalogStatus until completion. The download URL is provided in the status response when the job completes.

Downloading the catalog file (JSON for now) with the download URL will be in a separate PR, as it involves using a background session.

Testing:

Comprehensive test coverage includes:

• Parameter validation for all endpoints
• Response parsing for different catalog states (pending, processing, complete)
• Error handling and networking failure scenarios
• Edge cases for pagination and date handling

The endpoints are currently marked with periphery:ignore comments until integration with the broader catalog sync system is complete.

Steps to reproduce

Just CI passing is sufficient, as the remote isn't used in the app yet.

Testing information

I tested with

let catalogResponse = try await syncRemote.generateCatalog(for: siteID)
print("Job ID: \(catalogResponse.jobID)")
let jobID = catalogResponse.jobID
var isNotComplete = true
while isNotComplete {
    let statusResponse = try await syncRemote.checkCatalogStatus(for: siteID, jobID: jobID)
    if statusResponse.status == .complete {
        isNotComplete = false
        print("Job complete, download URL: \(statusResponse.downloadURL)")
    } else {
        print("Job status: \(statusResponse.status), progress \(statusResponse.progress), waiting 2 seconds...")
        try await Task.sleep(nanoseconds: 2_000_000_000)
    }
}

in the app to verify that the remote methods are working as expected.

• I have considered if this change warrants user-facing release notes and have added them to RELEASE-NOTES.txt if necessary.